Title Banner

Previous Book Contents Book Index Next

Inside Macintosh: QuickDraw GX Printing Extensions and Drivers /
Chapter 4 - Printing Messages / Printing Messages Reference
Printing Messages / Universal Imaging Messages


GXSetupImageData

QuickDraw GX sends the GXSetupImageData message to allow you to send initialization data that is specific to the kind of imaging system (raster, PostScript, or vector) that is being used for a job. You need to override the GXSetupImageData message if you want to modify imaging data. Your override of the GXSetupImageData message must match the following formal declaration:

OSErr MySetupImageData (void *imageData);
imageData
A pointer to imaging-system-specific data for initializing the printing device.
function result
An error code. The value noErr indicates that the operation was successful.
DESCRIPTION
QuickDraw GX sends the GXSetupImageData message to initialize data specific to the type of printer that is being printed to: raster, PostScript, or vector.

The default implementation of this message reads the default imaging information from resources within the specific driver.

SPECIAL CONSIDERATIONS
You never send the GXSetupImageData message yourself.

You almost always forward the GXSetupImageData message to other message handlers. Forward the message to get the default values of the imaging data filled in, and then change the data as you require.

RESULT CODES
gxSegmentLoadFailedErrA required code segment could not be found,
or there was not enough memory to load it.
gxPrUserAbortErrThe user has canceled printing.
SEE ALSO
You can find an example of an override of the GXSetupImageData message in
Listing 3-11 on page 3-36 in the chapter "Printer Drivers."

The raster imaging system structure, which contains the data used by the raster imaging system, is described on page 4-23.

The PostScript imaging system structure, which contains the data used by the PostScript imaging system, is described on page 4-26.

The vector imaging system structure, which contains the data used by the vector imaging system, is described on page 4-32.


Previous Book Contents Book Index Next

© Apple Computer, Inc.
7 JUL 1996




Navigation graphic, see text links

Main | Page One | What's New | Apple Computer, Inc. | Find It | Contact Us | Help